home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat2 / getpeername.0 < prev    next >
Text File  |  1996-09-01  |  2KB  |  43 lines
  1.  
  2. GETPEERNAME(2)             UNIX Programmer's Manual             GETPEERNAME(2)
  3.  
  4. NNAAMMEE
  5.      ggeettppeeeerrnnaammee - get name of connected peer
  6.  
  7. SSYYNNOOPPSSIISS
  8.      _i_n_t
  9.      ggeettppeeeerrnnaammee(_i_n_t _s, _s_t_r_u_c_t _s_o_c_k_a_d_d_r _*_n_a_m_e, _i_n_t _*_n_a_m_e_l_e_n)
  10.  
  11. DDEESSCCRRIIPPTTIIOONN
  12.      GGeettppeeeerrnnaammee() returns the name of the peer connected to socket _s. The
  13.      _n_a_m_e_l_e_n parameter should be initialized to indicate the amount of space
  14.      pointed to by _n_a_m_e. On return it contains the actual size of the name re-
  15.      turned (in bytes).  The name is truncated if the buffer provided is too
  16.      small.
  17.  
  18. DDIIAAGGNNOOSSTTIICCSS
  19.      A 0 is returned if the call succeeds, -1 if it fails.
  20.  
  21. EERRRROORRSS
  22.      The call succeeds unless:
  23.  
  24.      [EBADF]       The argument _s is not a valid descriptor.
  25.  
  26.      [ENOTSOCK]    The argument _s is a file, not a socket.
  27.  
  28.      [ENOTCONN]    The socket is not connected.
  29.  
  30.      [ENOBUFS]     Insufficient resources were available in the system to per-
  31.                    form the operation.
  32.  
  33.      [EFAULT]      The _n_a_m_e parameter points to memory not in a valid part of
  34.                    the process address space.
  35.  
  36. SSEEEE AALLSSOO
  37.      accept(2),  bind(2),  socket(2),  getsockname(2)
  38.  
  39. HHIISSTTOORRYY
  40.      The ggeettppeeeerrnnaammee() function call appeared in 4.2BSD.
  41.  
  42. 4.2 Berkeley Distribution        June 4, 1993                                1
  43.